PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager

Theme Brush Constants

The Appearance Manager provides the underlying support for RGB color data and overrides System 7 color tables such as 'cctb' and 'mctb' with an abstract mechanism that allows colors and patterns to be coordinated with the current theme. You can pass constants of type ThemeBrush in the inBrush parameter of SetThemeBackground , SetThemePen , and SetThemeWindowBackground to specify that the Appearance Manager substitute whatever the appropriate color or pattern is for a given human interface element in the current theme.

enum {
    kThemeBrushDialogBackgroundActive           = 1,
    kThemeBrushDialogBackgroundInactive         = 2,
    kThemeBrushAlertBackgroundActive            = 3,
    kThemeBrushAlertBackgroundInactive          = 4,
    kThemeBrushModelessDialogBackgroundActive   = 5,
    kThemeBrushModelessDialogBackgroundInactive = 6,
    kThemeBrushUtilityWindowBackgroundActive    = 7,
    kThemeBrushUtilityWindowBackgroundInactive  = 8,
    kThemeBrushListViewSortColumnBackground     = 9,
    kThemeBrushListViewBackground               = 10,
    kThemeBrushIconLabelBackground              = 11,
    kThemeBrushListViewSeparator                = 12,
    kThemeBrushChasingArrows                    = 13,
    kThemeBrushDragHilite                       = 14,
    kThemeBrushDocumentWindowBackground         = 15,
    kThemeBrushFinderWindowBackground           = 16,
    /* Brushes available in Appearance Manager 1.1 or later */
    kThemeBrushScrollBarDelimiterActive         = 17,
    kThemeBrushScrollBarDelimiterInactive       = 18,
    kThemeBrushFocusHighlight                   = 19,
    kThemeBrushPopupArrowActive                 = 20,
    kThemeBrushPopupArrowPressed                = 21,
    kThemeBrushPopupArrowInactive               = 22,
    kThemeBrushAppleGuideCoachmark              = 23,
    kThemeBrushIconLabelBackgroundSelected      = 24,
    kThemeBrushStaticAreaFill                   = 25,
    kThemeBrushActiveAreaFill                   = 26,
    kThemeBrushButtonFrameActive                = 27,
    kThemeBrushButtonFrameInactive              = 28,
    kThemeBrushButtonFaceActive                 = 29,
    kThemeBrushButtonFaceInactive               = 30,
    kThemeBrushButtonFacePressed                = 31,
    kThemeBrushButtonActiveDarkShadow           = 32,
    kThemeBrushButtonActiveDarkHighlight        = 33,
    kThemeBrushButtonActiveLightShadow          = 34,
    kThemeBrushButtonActiveLightHighlight       = 35,
    kThemeBrushButtonInactiveDarkShadow         = 36,
    kThemeBrushButtonInactiveDarkHighlight      = 37,
    kThemeBrushButtonInactiveLightShadow        = 38,
    kThemeBrushButtonInactiveLightHighlight     = 39,
    kThemeBrushButtonPressedDarkShadow          = 40,
    kThemeBrushButtonPressedDarkHighlight       = 41,
    kThemeBrushButtonPressedLightShadow         = 42,
    kThemeBrushButtonPressedLightHighlight      = 43,
    kThemeBrushBevelActiveLight                 = 44,
    kThemeBrushBevelActiveDark                  = 45,
    kThemeBrushBevelInactiveLight               = 46,
    kThemeBrushBevelInactiveDark                = 47,
    kThemeBrushBlack                            = -1,
    kThemeBrushWhite                            = -2
};
typedef SInt16 ThemeBrush;

Constant descriptions

kThemeBrushDialogBackgroundActive
An active dialog box's background color or pattern.
kThemeBrushDialogBackgroundInactive
An inactive dialog box's background color or pattern.
kThemeBrushAlertBackgroundActive
An active alert box's background color or pattern.
kThemeBrushAlertBackgroundInactive
An inactive alert box's background color or pattern.
kThemeBrushModelessDialogBackgroundActive
An active modeless dialog box's background color or pattern.
kThemeBrushModelessDialogBackgroundInactive
An inactive modeless dialog box's background color or pattern.
kThemeBrushUtilityWindowBackgroundActive
An active utility window's background color or pattern.
kThemeBrushUtilityWindowBackgroundInactive
An inactive utility window's background color or pattern.
kThemeBrushListViewSortColumnBackground
The background color or pattern of the list view column that is being sorted upon.
kThemeBrushListViewBackground
The background color or pattern of a list view column that is not being sorted upon.
kThemeBrushIconLabelBackground
An icon label's color or pattern.
kThemeBrushListViewSeparator
The color or pattern of the horizontal lines that separate rows of items in list view columns.
kThemeBrushChasingArrows
Asynchronous arrows' color or pattern.
kThemeBrushDragHilite
The color or pattern used to indicate that an element is a valid drag-and-drop destination
kThemeBrushDocumentWindowBackground
A document window's background color or pattern.
kThemeBrushFinderWindowBackground
A Finder window's background color or pattern. Generally, you should not use this constant unless you are trying to create a window that matches a Finder window.
kThemeBrushScrollBarDelimiterActive
The color or pattern used to outline the sides of an active scroll bar. Available with Appearance Manager 1.1 and later.
kThemeBrushScrollBarDelimiterInactive
The color or pattern used to outline the sides of an inactive scroll bar. Available with Appearance Manager 1.1 and later.
kThemeBrushFocusHighlight
The color or pattern of the focus ring around an element that is selected. Available with Appearance Manager 1.1 and later.
kThemeBrushPopupArrowActive
The color or pattern of the arrow on an active pop-up menu button. Available with Appearance Manager 1.1 and later.
kThemeBrushPopupArrowPressed
The color or pattern of the arrow on a pop-up menu button that is being clicked on by the user. Available with Appearance Manager 1.1 and later.
kThemeBrushPopupArrowInactive
The color or pattern of the arrow on an inactive pop-up menu button. Available with Appearance Manager 1.1 and later.
kThemeBrushAppleGuideCoachmark
The color or pattern of an Apple Guide coachmark. Available with Appearance Manager 1.1 and later.
kThemeBrushIconLabelBackgroundSelected
The color or pattern of the background of an icon's label area, when the icon is selected. Available with Appearance Manager 1.1 and later.
kThemeBrushStaticAreaFill
The background color or pattern of an element that does not support user interaction. Available with Appearance Manager 1.1 and later.
kThemeBrushActiveAreaFill
The color or pattern of an element that supports user interaction. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonFrameActive
The color or pattern that outlines an active button. Your application should draw the button outline outside the edge of the button. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonFrameInactive
The color or pattern that outlines an inactive button. Your application should draw the button outline outside the edge of the button. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonFaceActive
The color or pattern of the face of an active button. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonFaceInactive
The color or pattern of the face of an inactive button. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonFacePressed
The color or pattern of the face of a button that is being clicked on by the user. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonActiveDarkShadow
For an active button with a 2-pixel-wide edge, the color or pattern of the bottom and right sides of the outer ring of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonActiveDarkHighlight
For an active button with a 2-pixel-wide edge, the color or pattern of the top and left sides of the outer ring of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonActiveLightShadow
For an active button with a 2-pixel-wide edge, the color or pattern of the bottom and right sides of the inner ring of the edge. For an active button with a 1-pixel-wide edge, the color or pattern of the bottom and right sides of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonActiveLightHighlight
For an active button with a 2-pixel-wide edge, the color or pattern of the top and left sides of the inner ring of the edge. For an active button with a 1-pixel-wide edge, the color or pattern of the top and left sides of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonInactiveDarkShadow
For an inactive button with a 2-pixel-wide edge, the color or pattern of the bottom and right sides of the outer ring of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonInactiveDarkHighlight
For an inactive button with a 2-pixel-wide edge, the color or pattern of the top and left sides of the outer ring of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonInactiveLightShadow
For an inactive button with a 2-pixel-wide edge, the color or pattern of the bottom and right sides of the inner ring of the edge. For an inactive button with a 1-pixel-wide edge, the color or pattern of the bottom and right sides of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonInactiveLightHighlight
For an inactive button with a 2-pixel-wide edge, the color or pattern of the top and left sides of the inner ring of the edge. For an inactive button with a 1-pixel-wide edge, the color or pattern of the top and left sides of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonPressedDarkShadow
For a button with a 2-pixel-wide edge that is being clicked on by the user, the color or pattern of the bottom and right sides of the outer ring of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonPressedDarkHighlight
For a button with a 2-pixel-wide edge that is being clicked on by the user, the color or pattern of the top and left sides of the outer ring of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonPressedLightShadow
For a button with a 2-pixel-wide edge that is being clicked on by the user, the color or pattern of the bottom and right sides of the inner ring of the edge. For a button with a 1-pixel-wide edge that is being clicked on by the user, the color or pattern of the bottom and right sides of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushButtonPressedLightHighlight
For a button with a 2-pixel-wide edge that is being clicked on by the user, the color or pattern of the top and left sides of the inner ring of the edge. For a button with a 1-pixel-wide edge that is being clicked on by the user, the color or pattern of the top and left sides of the edge. Available with Appearance Manager 1.1 and later.
kThemeBrushBevelActiveLight
For an active bevel button, the color or pattern of the top and left sides of the bevel. Available with Appearance Manager 1.1 and later.
kThemeBrushBevelActiveDark
For an active bevel button, the color or pattern of the bottom and right sides of the bevel. Available with Appearance Manager 1.1 and later.
kThemeBrushBevelInactiveLight
For an inactive bevel button, the color or pattern of the top and left sides of the bevel. Available with Appearance Manager 1.1 and later.
kThemeBrushBevelInactiveDark
For an inactive bevel button, the color or pattern of the bottom and right sides of the bevel. Available with Appearance Manager 1.1 and later.
kThemeBrushBlack
Black; this color does not change from theme to theme. You may use this constant instead of specifying a direct RGB value. Available with Appearance Manager 1.1 and later.
kThemeBrushWhite
White; this color does not change from theme to theme. You may use this constant instead of specifying a direct RGB value. Available with Appearance Manager 1.1 and later.
© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)